Collection of Tools & Utilities/Collection of Tools and Utilities.iso/bbsutil/gapdemo1.zip/GAP.HLP

Text File | 1993-04-26 | 90KB | 2,814 lines

@@MAXLINE
Keywords are limited to 19 bytes
[---------------------------------------]
Set Margin to 41 in Brief F10, Margin
To reformat paragraphs imported from the
documentation, press F10, REFORM. Make
sure the block is marked first. You will
then have to insert a blank line between
paragraphs.
@@MENUH
To move between the various ^x0AMenu Choices^n
you may use the ^x0CLeft^n and ^x0CRight^n Arrow
Keys.

To select a ^x0AMenu Item^n, press ^x0CEnter^n
when the ^x0AItem^n you wish to select is
highlighted.

You may select a ^x0AMenu Item^n and have that
selection executed immediately by
typing the first character of the ^x0AMenu^n
^x0AItem^n's Name.
@@SET_MENUH
To move between the various ^x0AMenu Choices^n
you may use the ^x0CLeft^n and ^x0CRight^n Arrow
Keys.

To select a ^x0AMenu Item^n, press ^x0CEnter^n
when the ^x0AItem^n you wish to select is
highlighted.

You may select a ^x0AMenu Item^n and have that
selection executed immediately by
typing the first character of the ^x0AMenu^n
^x0AItem^n's Name.

If the current screen displayed is a
^x0AForum Configuration Screen^n and you are
not actually editing the screen, you may
toggle the display of the ^x0ATop^n or ^x0ABottom^n
portion of the screen by pressing the
^x0CS^n key. This will bring the bottom
portion of the screen into view if it
is not already viewable, and the top
portion of the screen into view, if the
bottom portion is currently being
displayed.
@@MDELH
This utility function allows you to
^x0AMass Delete^n all the files in a specific
subject.

It can be used when you need to quickly
remove a group of files.
@@MDELAREA
This is the Area where the files you
wish to delete are located.
@@MDELSUB
This is the Subject where the files you
wish to delete are located.
@@MDELFIL
If you would like for GAPFILE to also
delete the files from the hard drive,
answer ^x0CYes^n.
@@MDCONFIRM
You are being asked to confirm that you
indeed wish to go ahead and ^x0AMass Delete^n
the Area/Subject indicated. If you answer
^x0CYes^n at this point, then ^x0AGAPFILE^n will
delete the files.

Press ^x0CEsc^n or answer ^x0CNo^n if you do not
wish to continue.
@@GCONFIRM
You are being asked to confirm that you
indeed wish to go ahead and make the
^x0AGlobal Changes^n indicated. If you answer
^x0CYes^n at this point, then ^x0AGAPFILE^n will
change your ^x0AFileBase^n according to the
criteria you specified.

Press ^x0CEsc^n or answer ^x0CNo^n if you do not
wish to make any changes.
@@GCHANGE
Enter ^x0CY^n or ^x0CN^n here if you wish to
change the data in the ^x0AFileBase^n that
corresponds to this topic.

If you answer ^x0CYes^n in this field, press
^x0CEnter^n to move to the next two fields to
fill in the appropriate information.

The ^x0AOld Value^n is the data in the Filebase
that you wish to change to the ^x0ANew Value^n.
@@NAME
This is the name of the file that you
wish to enter into the database. This
field may not be left blank. In addition,
you will not be allowed to enter the name
of a file that does not exist.
@@WHERE
This is the disk directory where the file
is located.  It must be an existing DOS
directory.  This field defaults to the
upload directory as specified in
^x0AGAPSETUP^n.  ^x0AGAPFILE^n will check the
filename and the directory to see if the
file exists. If the file cannot be found
in the directory specified, the program
will seach all the directories on all the
disk drives specified on line 1 of the
configuration file, ^x0AGAPFILE.CNF^n. If the
file cannot be located, you will be
returned to the ^x0BName^n field to make
corrections.  Otherwise, the size of the
file and the last modification date will
be displayed for your convienence.

If you place the word ^x0BOFFLINE^n in this
field, then you may catagorize files
that you have available by request only.

The word ^x0BOFFLINE^n will prevent ^x0AGAPBBS^n
and ^x0AGAPFILE^n from performing certain
operations on the file.

If a file is ^x0BOFFLINE^n and a caller
attempts to download it, ^x0AGAPBBS^n will
automatically search your loose
directories for the file and if found,
will allow the download.
@@WHERE1
This is the disk directory where the file
is to be moved to. It must be an existing
DOS directory.
@@WHERE2
This is the disk directory where the
file ^x0Cused^n to be located.

If you have not yet moved the files from
the ^x0COld^n Directory to the ^x0CNew^n Directory,
then ^x0AGAPFILE^a will move them for you when
the ^x0AGlobal Change^n Executes.

For instance, if you have a private
upload directory in ^x0CD:\PRIVATE^n and
an upload directory in ^x0CD:\UP^n, where you
screen your uploads prior to posting,
you can use these ^x0AWhere^n fields to move
your private uploads to the public
upload directory.

If your private uploads are in ^x0AArea^n ^x0C0^n,
^x0ASubject^n ^x0C11^n, and your public uploads are
in ^x0AArea^b ^x0C0^n, ^x0ASubject^n ^x0C10^n, you can change
the ^x0AWhere^n field from ^x0CD:\PRIVATE^n to
^x0CD:\UP^n and change the Subject field from
^x0C11^n to ^x0C10^n.

^x0AGAPFILE^n will change the ^x0ASubject^n field
for each file in the private upload
directory and will change the ^x0AWhere^n
field as well. In addition, ^x0AGAPFILE^n
will physically move the files from
^x0CD:\PRIVATE^n to ^x0CD:\UP^n.

If you use a scheme such as suggested
above, be sure that you also enter ^x0C0^n in
the ^x0AArea To Change^n field and ^x0C11^n in the
^x0ASubject To Change^n field.

Otherwise, in addition to changing the
^x0AWhere^n field, ^x0AGAPFILE^n will also change
any file that has a ^x0ASubject^n field of ^x0C11^n
to a new subject of ^x0C10^n, and this could
include some of your Forums.

Be specific, when changing fields.

If you enter an ^x0C*^n as the only character
in this field, and enter just a drive
designation in the ^x0ANew Value^n field,
^x0AGAPFILE^n will modify just the drive
designation, leaving the directory the
same.

For instance, if you enter ^x0C*^n in the
^x0AOld Value^n field and ^x0CF:^n in the ^x0ANew Value^n
field, and the Where field for a file
is ^x0CD:\DL1^n, ^x0AGAPFILE^n will change the Where
field to ^x0CF:\DL1^n.

When using this feature, the file will
not be physically moved.
@@WHERE3
This is the disk directory where files
are now located or where they will be
located after ^x0AGlobal Change^n is finished.

If this directory is different from the
old directory, then ^x0AGAPFILE^n will attempt
to move the file from the old directory
to the directory you specify here. You
may use this ^x0AGlobal Change^n option in
conjuntion with other options and
physically move your files around in the
^x0AFileBase^n.
@@LENGTH
This is the size of the file in bytes.
Normally you would simply press [^x0CEnter^n]
on this field as the actual size is
provided for you.
@@FDATE
This is the date the file was last
modified.  The actual file date is
provided for you.
@@LACCESS
This is the date the file was last
downloaded.  It is updated by ^x0AGAP^n
whever a caller downloads the file.
@@TACCESS
This field holds the total number of
times the file has been downloaded. It
is maintained by ^x0AGAP^n.
@@TACCESS1
Enter the old value for the total
number of downloads a file has incurred.

For instance, if a file had ^x0C100^n down-
loads and you wish to change the count
to ^x0C1^n download, enter ^x0C100^n in this field.
@@FREE
Free file means a user may download the
file without having the download credited
against him or her.  If you wish to
utilize this feature, enter ^x0CY^n.
@@FREE1
Enter the old value of the ^x0AFree^n file
field.
@@FREE2
Enter the new value of the ^x0AFree^n file
field.
@@NORMAL
A Normal Log is a caller log entry in
which ^x0AGAP^n writes a specific code to the
caller log.

This code tells ^x0AGAPCALL^n that a file was
downloaded and ^x0AGAPCALL^n will then use
the name of that file in one of the
bulletins that it produces.

If you have security specific files or
files that you do not want regular
callers to see in the bulletin that
^x0AGAPCALL^n produces, then set this field
to ^x0CN^n.
@@NORMAL1
Enter the old value of the ^x0ANormal^n log
field.
@@NORMAL2
Enter the new value of the ^x0ANormal^n log
field.
@@HAREA
Area is the area of the board the file
will be available in. ^x0C0^n = Main Board,
^x0C1^n - ^x0Cxxx^n = Forum Number. If the file is in
a Forum, you will be allowed to enter a
Forum number only if it is within the
range of Forums that you have set up.
@@HAREA1
This is the Area of the board that the
file ^x0Cused^n to belong in.

^x0C0^n = Main Board.
^x0C1^n - ^x0Cxxx^n = Forum Number.

For instance, if you move some files from
^x0AForum 3^n to the ^x0AMain Board^n, you would
enter ^x0C3^n in this field.
@@HAREA2
This is the Area of the board that the
file is ^x0Cnow^n located in.

^x0C0^n = Main Board.
^x0C1^n - ^x0Cxxx^n = Forum Number.

For instance, if you move some files from
^x0AForum 3^n to the ^x0AMain Board^n, you would
enter ^x0C0^n in this field.
@@GAREA
Enter here the ^x0AArea^n of the board you
wish to perform these Global Changes in.

If you enter ^x0CALL^n in this field, ^x0AGAPFILE^n
will change all areas of the board that
match any of the criteria you have set.

If you enter ^x0c0^n in this field, ^x0AGAPFILE^n
will change only the Main Board files.
@@HAREA1
This is the Area of the board that the
file ^x0Cused^n to belong in.

^x0C0^n = Main Board.
^x0C1^n - ^x0Cxxx^n = Forum Number.

For instance, if you move some files from
^x0AForum 3^n to the ^x0AMain Board^n, you would
enter ^x0C3^n in this field.
@@HSUBJECT
This is the Subject Number of the file.
A List will be displayed showing the
available subjects.  You may select from
the list by using the [^x0CHome^n] and [^x0CEnd^n]
Keys to move the cursor. Pressing [^x0CEnter^n]
will select the highlighted selection.
You may also type in the Subject Number
directly.  If the file is located in a
Forum, as specified by the Area field,
you will only be allowed to enter a
subject that is unique to that particular
Area.  For instance, you cannot select a
Subject that is part of the main board.
@@SUBJECT1
This is the Subject of the Area that the
file ^x0Cused^n to belong in.

This field would be used mainly in con-
junction with the previous Area field,
when you move files from one Area/Subject
to another.
@@SUBJECT2
This is the Subject of the Area that the
file is ^x0Cnow^n located in.

This field would be used mainly in con-
junction with the previous Area field,
when you move files from one Area/Subject
to another.
@@GSUBJECT
Enter here the ^x0ASubject^n of the previous
^x0AArea^n you selected that you wish to
perform these Global Changes in.

If you wish to perform these global
changes only in the Main Board and
in Subject 1, you would enter 0 in the
previous field and 1 in this field.

If you wish to perform the changes in
All Areas and All Subjects, you would
enter ALL in the previous field and
ALL in this field.
@@GEXT1
This is the Filename Extension of the
files that you wish to change to the New
Extension.
@@GEXT2
This is the Filename Extension that you
wish to give to the files that have the
Old Extension.
@@SECURITY
This is the security level needed to
download and view the file. It defaults
to the level you gave in configuration
for the ^x0ASecurity Level For Uploads^n field
@@SECURITY1
This is the ^x0Cold^n security level needed
to download and view a file.

If you enter ^x0C999^n in this field then
^x0AGlobal Change^n will change all security
levels in the FileBase that are less
than 0 or greater than 999 to the ^x0ANew^n
^x0ALevel^n you specify.
@@SECURITY2
This is the ^x0Cnew^n security level needed
to download and view a file.
@@UPLOADED
This is the name of the person who
uploaded the file.  When entering files
manually, this field defaults to ^x0ASYSOP^n.
@@PASSWORD
This is the password needed to download
the file.  If you do not wish to password
protect the file, leave this field blank.

The ^x0C@^n character may not be used as the
first character in the password since
this character is used to specify an
indirection file that holds the names of
authorized downloaders.

If you wish to use an indirection file,
enter the name of the file, preceeded
by an ^x0C@^n, for instance: ^x0A@GROUP1^n.

Place the file GROUP1 in the directory
you specified in configuration as the
indirection directory. In this file,
enter the complete names of those users
that are authorized to download this
file. You must enter the First and Last
names, separated by a space, one name
per line.

When a user tries to download a file
that has an indirection file associated
with it, if the user's name cannot be
found in this file, the user will be
told that he/she is ^x0CNot Authorized^n.
@@PASSWORD1
This is the password that was needed to
download a file. Enter the password you
wish to change here.
@@KEYWORD
The Keywords are a line of text that will
be displayed to the user whenever a
^x0ACondensed^n file function is performed.
They are also used as the basis for a
finding files when the caller uses the
^x0ALocate^n command.  The words should be
separated by one space.
@@EDITOR
The ^x0AFile Description^n will be shown to the
caller whenever an ^x0AEnhanced^n file
function is performed.  The description
may be up to 10 lines long. Pressing [^x0CF2^n]
while in the ^x0ADescription Editor^n will show
a list of the available ^x0AEditor Keys^n.
@@SUBJECT1
This list displays the available
subjects.  If the file currently
displayed is in a Forum, the list will
display the subjects for that specific
Forum.  To scroll thru the list, use the
[^x0CHome^n] key to scroll up and the
[^x0CEnd^n] key to scroll down.
@@UPDATEH
^x0AUpdate^n is a means whereby ^x0AGAPFILE^n will
check the database against the files on
the disk to see if the location, size
and date are correct. You have the option
of checking only the current subject or
all subjects.  You may specify whether or
not the file date should be updated and
whether or not to delete the ISAM record
if the file cannot be found on the disk.

Use ^x0CDelete^n with caution as it will
permanently remove the file from the
database.
@@MASTERH
^x0AMaster List^n will produce a text file
listing of your files.  This is useful
for posting a list of files for your
callers to download.  You may specify
whether or not you want a condensed or
enhanced listing, whether or not to
produce a listing for all areas or the
currently selected area, and whether or
not to show the download times at various
baud rates.
@@STRAYH
^x0AStray Files^n allows you to search a disk
directory for any files that are on the
disk but not classified in the database.
If you select ^x0APrompt For Description^n, you
will have the opportunity of typing in a
description and a list of keywords for
each file that was found; otherwise the
files will be saved in the database with
a keyword and description of
^x0AUNCLASSIFIED^n.  You first set up the
directory you wish to have searched and
then specify the ^x0ADestination Area^n and
^x0ASubject^n.  This function is normally used
to classify files you have just
downloaded as new uploads.

When Importing the Stray Files, GAPFILE
will shell to a batch file (default is
your UPCHECK.BAT) to check for viruses
and extract a FILE_ID.DIZ out of the
archive (if there is one).

When shelling, GAPFILE will create a
Window on the screen where all DOS
output will be redirected. Some virus
checkers, however, use direct screen
writes and GAPFILE's DOS Window can not
properly contain these screen writes
inside the Window. If you would like for
GAPFILE to not put up a DOS Window,
toggle the ^x0AUse DOS Window^n prompt ^x0COff^n.
@@IMPORTH
^x0AImport^n is a means whereby you may
import files from a text based file
listing (an RBBS or PCB DIR listing), or
from one of your own Condensed Listings
produced with the Master List Utility
function.

To use the Import feature, you will need
an RBBS type DIR listing that is
formatted the same as the Condensed
Master List produced by GAPFILE (without
the transfer options and the header and
subject descriptions) :

 FILENAME.EXT   99999  01/01/90  Descrip

There should be 1 entry per line, with no
blank lines anywhere in the file.

You will have the option of specifying
the name of this file as well as the
Area, Subject, and Source Directory. The
Source Directory is the directory that is
placed in the 'Where' field of the
FileBase.
@@MOVEH
^x0AMove^n Files is a global version of the
regular ^x0AMove File^n function.  It will
display a list of files for the subject
specified and will allow you to type in
a new subject for each of the files. You
may also specify a new area. If you wish
to delete a file, type ^x0C0^n for its
subject number. If you wish to leave the
file where it is, leave its subject and
area numbers the same (i.e., don't
change them).
@@GLOBALH
^x0AGlobal^n is a means whereby ^x0AGAPFILE^n will
change specific fields that you specify
from ^x0Cold^n values to ^x0Cnew^n values.

For instance, if you initially set up
your ^x0AFileBase^n with a default Download
Level of ^x0C40^n and you now wish to change
this level to ^x0C50^n, this Utility will
allow you to do so.

^x0CBe extremely careful when using this^n
^x0CUtility Function. You cannot damage your^n
^x0CFileBase, however, you can jumble the^n
^x0Cdata such that many or all of your^n
^x0Crecords will contain information they^n
^x0Care not supposed to have.^n

You may change most of the fields in the
^x0AFileBase^n. Some of the fields that you
are allowed to change require that you
perform certain file operations in DOS
prior to changing the fields.

For instance, if you move files from
Subject 9 (DIR 9) to Subject 1 in the
Main Board, you can use the Global
Change Utility to change any file with
an Area 0, Subject 9 to Area 0,
Subject 1.  In most cases, this would
be faster than using the ^x0AUpdate^n Utility.

You can also change the above example so
that Files in Area 0, Subject 9 are
changed to Area 0, Subject 1, and also
change the ^x0AWhere^n field so that the files
are moved from Subject 9 to Subject 1.

When you change the ^x0AWhere^n field, ^x0AGAPFILE^n
will physically try to move the file
from the old directory to the new
directory.
@@DUPEH
This Utility function allows you to re-
move duplicate records from the data
base.

If you receive a message while rebuild-
ing your data files that says ^x0ADuplicate^n
^x0AKey rejected for record at offset xxxx^n,
where ^x0Cxxxx^n is a numeric value, then
there are duplicate records in your data
base and only one of them could be
indexed.

With this Utility, you may remove the
duplicate records.

GAPFILE will show you some information
about the record and then ask if you
wish to delete it.

In order to delete the duplicate record
you must supply the numeric offset that
^x0AGAPREBLD^n displayed in its warning
message. You ^x0Cmust^n supply the exact
number or you may inadvertantly delete
the wrong record.

If GAPREBLD gave duplicate warning
messages for the same offset value, you
need only remove the duplicate record
once. For instance, if GAPREBLD gave 3
separate duplicate key messages with all
3 having the same offset value of 29993,
simply supply the value of 29993 to this
Utility function ONE time and the record
will be correctly deleted.
@@DUPE_OFFSET
Enter the Offset Value that GAPREBLD
displays when reporting a Duplicate
Key error.
@@DUPE_DELETE
You are being asked to confirm that you
wish to delete this record. If the file
exists on the disk drive, it will not
be deleted so you may reclassify the
file in the database.

Note that if you do ^x0Cnot^n delete this
record, you will continue to receive
^x0ADuplicate Key Rejected^n messages when
rebuilding the Index files.
@@KEYH
This Utility function allows you to re-
build your Keyword Data and Index files.

Normally you would only fix your Keyword
files if they become damaged.

Depending upon how many files you have
in the Filebase, this utility can take
up to 4 hours or more to complete.
@@KCONFIRM
You are being asked to confirm that you
wish to rebuild your Keyword Data Files.

Depending upon how many files you have
in the Filebase, this utility can take
up to 4 hours or more to complete.
@@SUB1
This is the Subject Number of the file.
If you wish to see a list of available
subjects, press [^x0CF10^n]. If the file is
located in a Forum, as specified by the
Area field, you will only be allowed to
enter a subject that is unique to that
particular Area. For instance, you
cannot select a Subject that is part of
the main board.
@@SET1
The ^x0CSysop's Name^n is the name ^x0AGAP^n uses
when refering to you. Normally you enter
just your first name.
@@SET1A
The ^x0CLogon Password^n is the password re-
quired to log onto the system from the
local console.
@@PRIV_MAIL_LEV
This is the security level needed to
read Private Mail.
@@PRIV_COM_LEV
This is the security level needed to
read Comments. Private Mail and Comments
are not the same, even though a comment
is private.
@@SET1D
This is the security level needed to
Protect or Unprotect a Message. Pro-
tecting a messages means to make the
message private. Unprotecting a message
means to make it public.
@@SET1E
This is the security level needed to
read messages addressed to the person
reading the message and not have the
Read Flag (i.e., date and time the
message was read) set. This feature is
invoked by using a 'U' in the Read Mail
Command (i.e., R Y S U).
@@SET1F
This is the security level needed to
Edit Message Headers.
@@SET1G
This is the security level needed to
overwrite existing files during an
upload.
@@SET1H
This is the security level needed to
view the Caller Log.
@@SET1I
This is the security level needed to
view Information about your Users.
@@SET1J
This is the security level needed to
view any system file.
@@SET1K
This is the security level needed to
use the Online User Editor.
@@SET1L
This is the security level needed to
execute DOS Functions (i.e., exit to
DOS from remote and perform DOS Commands.
@@SET1N
This is the security level needed to
View the other Node Caller Logs.
@@SET1O
This is the security level need to
Attach Files to Messages.
@@SET1P
This is the security level needed to
recover messages that were deleted.
@@SET2
These are the names of various system
files. It is suggested that you leave
these names as they are. If you are
running multiple nodes, you may change
any of these names to make the respec-
tive file unique for a particular node.

The ^x0CTimes/Bytes File^n is a file which
contains security levels, time allot-
ments, allowable download bytes & files
per day, and file ratios that must be
maintained.

The ^x0CTrashcan File^n contains names that
you do not wish to be used by a caller.
@@SET3
These are the Disk Directories ^x0AGAP^n uses
in order to operate.

Each entry must begin with a drive
designator and the entries must conform
to valid DOS path specifications.

Files uploaded to the board will be
placed in the ^x0CUpload Directory^n.

All of your general purpose files will
be placed in the ^x0CGeneral Directory^n. Such
files would be your Welcome, News, Menus,
and Bulletins.

The ^x0CMain Directory^n holds files that are
written to. It must never be a RAM disk.

The ^x0CHelp Directory^n holds all the help
files.

Files that are not classified in the
FileBase but which you would like to
be available for downloading, may be
placed in the ^x0CLoose Directory^n. When ^x0AGAP^n
cannot locate a file in the FileBase
it will look for it in this directory.

The ^x0CIndirection Directory^n holds the
files that GAP will read if a Password
field in a file that is to be downloaded
contains an ^x0C@^n as the first character.
The chapter in the GAP Manual ^x0AFileBase^n
^x0AEditor^n, contains a full description on
how to use indirection files with GAP.
@@SET4
The ^x0CModem Reset String^n is the string to
send to the modem to set it to its
default power on state.

If your modem is slow to respond to
commands, you should use two ATZ's along
with several pauses. If, for instance,
^x0AGAPMENU^n displays the message "Modem Not
Responding", try adding some pauses to
your ^x0CModem Reset String^n.

The following reset string will work for
most modems:

           ^x0AATZ{~~ATZ{~~^n

@@SET4A
The ^x0CModem Init String^n is the string to
send to the modem to Initialize it. If
the power on defaults are adequate you
do not need to use an Init string. Note
that in most cases, the power on defaults
are ^x0Cnot^n adequate.

Be sure that the S7 register is set the
same as ^x0CSeconds To Wait For Carrier^n. If
you want the modem to wait 60 seconds
before giving up when it attempts to
establish a carrier with a remote modem,
use S7=60 in your Init String and set
Seconds To Wait For Carrier to 60.
@@SET4B
The ^x0CModem Off Hook String^n is the string
to send to the modem to take it off the
hook. For most modems, the default will
work just fine.
@@SET4C
^x0CSeconds To Wait For Carrier^n is the
number of seconds you want to wait
before giving up when attempting to
establish a carrier with a remote modem.
This number should match your S7=
parameter in the ^x0CModem Init String^n.
@@SET4D
^x0CSeconds To Wait For Connect^n is a special
field just for slow modems. If you find
that ^x0AGAPENU^n recycles as soon as a
carrier is established or that the
caller is logged into the board at the
wrong baud rate, set this field to ^x0C2^n or
more seconds.

This field causes ^x0AGAPMENU^n to wait the
number of seconds specified before it
looks for a ^x0CCONNECT^n message from the
modem.  If ^x0AGAPMENU^n looks too soon, it
may never see the message or it may
receive the ^x0CCONNECT^n part of the
message but not the baud rate which
follows it. If ^x0AGAPMENU^n doesnt see the
message at all, it will recycle. If
it sees the ^x0CCONNECT^n but not the baud
rate, chances are it will log the
caller into the board at 300 baud.
@@SET4E
The ^x0CCommunications Port^n, ^x0CIRQ^n, and ^x0CBase^n
fields allow you to customize ^x0AGAP^n's
communications handler to your needs.

If you are using COM 1 or COM 2, you
need only enter 1 or 2 in the Port field.
^x0AGAP^n will use the default IRQ and Base
address for these ports.
@@SET4F
The ^x0CInitial BPS Rate^n is the rate you
wish to open the Communications Port at.
This should be the highest baud rate at
which your modem is capable of operating.
@@SET4G
^x0CLock BPS Rate^n is used for modems which
can communicate with the computer at
one rate and the remote modem at
another. It is typically used with 9600
baud (or higher) modems. If set to Yes,
^x0AGAP^n will keep the Communications Port
locked in at the Initial BPS Rate you
specified, rather than changing the baud
rate to match that of the caller.
@@SET4H
^x0CAnswer On True Ring Detect^n tells ^x0AGAPMENU^n
how to answer the phone. If set to ^x0CYes^n,
^x0AGAPMENU^n will answer the phone as soon
as the Ring Detect line from the COM
port indicates that the phone is ringing.
If set to ^x0CNo^n, ^x0AGAPMENU^n must continuously
monitor the input receive buffer for the
word RING.

You may need to experiment with this
setting. Most modems will work very well
with it set to Yes. However, modems that
are slow to respond to commands will not
work unless this field is set to No. The
reason for this is that if ^x0AGAPMENU^n sends
an ATA to tell the modem to answer the
phone when the modem isnt ready to
receive the ATA, your phone will never
be answered.
@@SET4I
If you have a fast hard drive and a
buffered modem, you may set the ^x0CFull^n
^x0CFlow Zmodem Uploads^n to Yes. Even if
you do not have a fast hard drive but
^x0Cdo^n have a ^x0A16550 UART^n installed you may
be able to utilize this feature.

Basically it tells ^x0AGAP^n to tell the
sending Zmodem program to send the
entire file as 1 large block. The
sending program will not wait for ^x0AGAP^n
to write its buffer to disk or to ACK
each individual block of data. This
results in faster Zmodem uploads.

If, during a Zmodem upload, you see
a number of CRC errors, you will
need to set this flag to No.
@@SET4J
^x0CAllow Restricted Callers^n allows you
to restrict access to your BBS to
certain baud rates. If you answer No,
then callers at the baud rate you
specify will not be allowed access. If
you answer Yes, then callers at the
specified baud rate will be allowed
access, but only during the specified
time. If you wish to allow all baud
rates equal access, leave the start and
end times set to ^x0A00:00^n. Otherwise, the
start and end times represent the
period in which the callers ARE allowed
access.
@@SET4K
In this field, enter the number of rings
that must occur before GAPMENU will
answer the phone. Normally, this is set
to 1 and should not be changed unless you
have a special need.
@@SET4L
This field allows you to prohibit any
caller that attempts to log on to your
system with the ^x0CHighest BPS Rate NOT^n
^x0CAllowed^n from gaining access to your
system.

If you would like to prohibit 300 baud
callers from gaining access, you would
enter 300 in this field. Any caller that
attempts to log on to your system at
this baud rate will be denied access.

Note that you may use this option, along
with the ^x0CHighest BPS Rate To Restrict^n
option to prohibit some baud rates and
yet allow other baud rates during
certain times of the day. This option
takes precedence over the other, meaning
that if you prohibit 300 baud callers
and yet enter 300 as the ^x0CHighest Rate^n
^x0CTo Restrict^n and a 300 baud caller calls
during a time when you would like to
allow them on, the 300 baud caller will
not be allowed on at all.

If you would rather restrict certain
baud rates to certain hours of the day
or not restrict them at all, then leave
this field blank.
@@SET4M
When a caller attempts to interrupt the
display of a screen by typing ^x0CCtrl-K^n,
^x0CCtrl-X^n, or ^x0CSpace^n, if your modem has its
own internal buffer, the modem will
continue to send the screen to the
caller until its buffer is emptied. With
most modems, ^x0AGAP^n can force the modem to
empty its buffer by sending a ^x0ABREAK^n
signal.

However, some modems do not react too
kindly to this ^x0ABREAK^n signal and you may
need to disable this feature. If this
is the case, then answer ^x0CNo^n in this
field.

If you are using a USRobotics modem with
an internal buffer, be sure your ^x0C&Yx^n
command is set to ^x0C&Y1^n (this is the
default for these modems).
@@SET4N
Some modems will only work if ^x0AModem^n
^x0ACommands^n are sent to them as if a human
were typing the commands on a terminal.

^x0CUse Inter Character Delay^n should be set
to ^x0CNo^n unless you experience problems
with your modem not recognizing the ^x0CINIT^n
and ^x0CRESET^n strings that ^x0AGAPMENU^n sends.
@@SET4O
If you have a slow hard drive, use
extended memory for a disk cache, or
encounter errors during uploads and
you cannot attribute the errors to line
noise, you may need to set this option
to ^x0CYes^n.

Turning ^x0CRTS^n off during a disk write
tells your modem to stop sending data to
the computer while ^x0AGAP^n is writing the
block of data to the disk.

Note that this flag will have no
effect if your modem does not support
hardware handshaking (^x0ACTS/RTS Flow^n
^x0AControl^n).
@@SET4P
Normally, GAP determines the caller's
Connect rate from the CONNECT string that
the modem returns after a connection has
been established.

Some high speed modems will return the
DTE (computer to modem) CONNECT rate
instead of the caller's actual bps rate.

This means that if you lock your COM port
at 38400 bps, the modem will ALWAYS
return a Connect rate of 38400, even if
the caller is actually connected at
2400 bps.

This causes no actual harm except that
GAP uses the caller's bps rate to
determine how many files a caller can
download, amoung other things. A caller
at 2400 bps would actually be able to
que up as many files as a 9600 bps
caller!

If your modem returns the caller's actual
Connect rate, simply enter CONNECT in
this field. Most modems do return the
proper connect speed.

If, on the other hand, your modem is one
of those that insists upon returning the
DTE rate, you may enter the bps rate you
would like to have GAP use when
determining the number of files a caller
can download, tranfer efficiency ratings,
etc.

If you lock your port at 38400, then a
good bps rate here would be 9600. Or, if
you would like to even things out for
high speed callers and low speed callers,
you can enter 4800 in this field.
@@SET5
This screen allows you to set the
security levels for the Main Menu Com-
mands.

New Users are given the level specified
for ^x0CNew User Level^n.
@@SET5A
You may define two Custom Menu Choices.

In the first field, you enter the Menu
Command a caller must type in order to
execute this Menu Item.

In the second field, you enter the
security level needed for this Command.

When a caller selects one of your Custom
Menu Items, ^x0AGAP^n will shell to DOS and
execute a Batch file with the same name
as the Menu Item.

For instance, if you enter ^x0AORDER^n for a
Custom Menu Item, ^x0AGAP^n will shell to a
batch file called ^x0CORDER.BAT^n. This batch
file can then run on Online Order Entry
program.

Try to use names that do not duplicate
batch files you may already have in your
^x0AGAP^n Default directory.

Your Custom Menu Item names may be from
2 to 5 characters.
@@SET6
This screen allows you to set the
security levels for the File Menu Com-
mands and the View/Change Stats Commands

If you wish to prevent new callers from
accessing the Files System, on the pre-
vious screen, set the level for the
[^x0CF^n]iles Command higher than the level
given to new users.
@@SET7A
Bulletins is the maximum number of
bulletins you intend to make available
to your callers. The bulletins are
listed in a file called BLT which goes
in your GEN directory along with the
individual bulletins (which are named
BLTxx, where xx is the bulletin number).
@@SET7B
The printer port is the Line Printer
Port you wish to have ^x0AGAP^n write the
caller log to. Printer Logging is turned
on from the Main Menu with the Printer
Toggle.
@@SET7C
If ^x0CEnforce Time Limit^n is set to Yes,
users will not be allowed access if
their time limit for the day has ex-
pired. They must wait until the follow-
ing day before ^x0AGAP^n will allow them back
on. If set to No, ^x0AGAP^n will allow any
caller to log on as many times as they
wish in any given day.
@@SET7D
If you are running a closed board, set
the ^x0CClosed Board^n option to Yes. A closed
board is one in which no new users are
allowed access. A user must already exist
in the user file in order to gain access.
In addition, the user flag ^x0CPrivate User^n
must be set to Yes (^x0AUser Editor^n). This
feature is handy if you run a Subscrip-
tion board, as new callers will not be
allowed access until ^x0AYOU^n give them that
right.
@@SET7E
It is your choice as to whether or not
you want ^x0AGAP^n to ask a caller for his/her
birth date when first registering. If
this field is set to yes, ^x0AGAP^n will ask
but it should be noted that the caller
may simply press Enter and bypass the
prompt. Callers can always change their
date of birth at the View/Change Stats
Menu (providing you have Allow Name
Changes set to Yes).
@@SET7F
You may set up Forums that allow callers
to use a handle instead of their real
name. The ^x0CAllow Handles^n field is used
so that ^x0AGAP^n knows whether or not to
allow a caller to give himself a handle.
If set to ^x0CYes^n, users may give themselves
a handle at the View/Change Stats Menu.

If you enable the handle feature, you
must also set the appropriate flag for
each Forum that will allow handles. This
is done in the Forum Configuration
Screen.
@@SET7G
If you wish to allow users to change
their address, phone numbers, and birth
date, while on line, set this field
to Yes.
@@SET7H
This field will insure that new users
enter the required information at regis-
tration. Phone numbers will be validated
as to their content. If a user enters a
number such as ^x0A(555)555-5555^n they will
be allowed on but as soon as they arrive
at the main command prompt, they will be
locked out and disconnected. New sysops
tend to not like this feature where as
sysops who have been running a BBS for
some time turn it on in order to weed
out undesirable callers.
@@SET7J
If you wish to force new callers to
view the Bulletin Menu when they first
log on, set the ^x0CForce BLT Menu At Logon^n
to Yes.
@@SET7K
If set to Yes, this field will cause the
User Status Display to be shown to all
callers when they first log on. If set to
No, the Stats will be displayed only to
new callers. Users can always view their
stats at the View/Change Stats menu.
@@SET7L
You may define the Phone Number Template
that GAP uses when gathering input for
Phone Numbers.

The default template is the one used in
the U.S.

What you enter into this field are
"special" characters that the cursor
will "skip over" when data is being
input.

The special characters are: ( ) -

Actual data entry takes place wherever
there is a '9' or an 'X' in the
template.

A '9' means only numbers are allowed. An
'X' means any character is allowed.
Generally, you would use all X's in the
field if you live in a country where
there are various types of phone numbers
and using a Template just wouldn't work
with all callers.

As an example, in Switzerland you could
use the following template:

    999-99-99-9-99

If you will never accept international
calls you could eliminate the country
code and use the following template:

    99-99-9-99
@@SET7M
^x0CAllow Quick Logon^n is a method to prevent
callers from typing ^x0AY Q NS^n (or ^x0AN Q NS^n)
at the ^x0ALogon Color Prompt^n to keep from
viewing the Welcome and News files.
@@SET7N
^x0CLevel To Override Login^n is the
minimum security level a caller must
have in order to override your News,
Security News, and other login
screens.

The Override Command was designed for
Network Hubs so that their Nodes can use
a Script to logon and transfer mail.

On such a HUB, you should set this field
to the level you give your Node Sysops
so that they can log on automatically
using their scripts.

This option is provided so that in case
of hardware crashes or the like, you can
insure that your callers read your News
and other such files.
@@SET7O
If you do not want ^x0AGAP^n to show the name
of the last caller, set the ^x0CShow Last
^x0CCaller^n field to No.
@@SET7P
If you would like to have ^x0AGAP^n enforce
registration by validating the ^x0AHome^n
^x0APhone Number^n field but don't really care
if a New User enters a ^x0ABusiness^n or ^x0AData^n
^x0APhone Number^n, you may set this field to
^x0CNo^n and ^x0AGAP^n will allow callers to skip
the ^x0ABusiness/Data Phone^n prompt or enter
erroneous information if they prefer.
@@SET7Q
Normally when a caller exists thru a
Door, ^x0AGAP^n uses the caller's Real Name
instead of his/her Handle. If you would
like for ^x0AGAP^n to write the caller's
Handle to ^x0ADOOR.SYS^n, set this field to
^x0CYes^n.
@@SET7R
^x0AGAP^n maintains mini statistics on the
activity of your system. These stats are
reset each day when the first caller
after midnight logs off.

These statistics are displayed in a
window on the ^x0ACall Waiting Screen^n.

If you would like for ^x0AGAP^n to create a
Bulletin containing these statistics,
enter the ^x0CBulletin Number^n to use in this
field. If you do not want ^x0AGAP^n to create
this Bulletin, enter ^x0C0^n in this field.

If you would like for both sets of
statistics to appear in the same file,
enter the same Bulletin Number for
Yesterday's Stats and Monthly Stats.

If you would like to have the bulletins
created but do not want them to appear
as a regular bulletin (where your
callers can view them), simply give
them numbers greater than the highest
bulletin you have configured. For
instance, if you normally carry 14
bulletins, you can give these Caller
Stats bulletins the numbers 15 & 16. Or
just simply 15 for a combined bulletin.

Note that the bulletins are created
using XCodes. You may view them inside
of GAPBBS either as a bulletin or by
using Sysop Function 3 (Type File).

Note that if you run multi nodes, GAP
will write only the Network Wide portion
of the stats. In other words, the
bulletin will not contain the statistics
for any particular node.

In addition, if you maintain seperate
GEN directories, the bulletins will be
writen to the GEN directory of which
ever Node logs the first caller off
after midnight (the first Node that does
the actual re-setting of the stats). You
will need to devise some means of making
sure the bulletins are consistent
between nodes.
@@SET7S
If set to ^x0CYes^n, then whenever there are
^x0ANew Bulletins^n (as determined by the date
on the BLT Menu file), callers will
automatically be taken to the Bulletin
area. If set to ^x0CNo^n, callers will still
be told there are new bulletins, but
they won't be forced to view the
^x0ABulletin Menu^n.
@@SET8A
In multi-user systems, you must give
each node a separate number.

The ^x0CMaximum Nodes To Use^n is the number of
Nodes to be shown on the ^x0AWHO^n and ^x0ACHAT^n
displays and on the ^x0ANetwork Monitor^n
^x0AWindow^n in ^x0AGAPMENU^n. For instance if you
have the ^x0C99^n Node version of ^x0AGAP^n and yet
you have only ^x0C8^n active Nodes, by setting
this number to ^x0C8^n, Nodes ^x0C9^n - ^x0C99^n won't
appear on these displays as ^x0ANode Is Not^n
^x0AActive^n.

You will not be able to set this number
lower than the Node Number and it should
be set the same for ^x0CALL^n nodes in the
system.

If you are running a Network that uses
NetBios, ^x0AGAP^n has the unique ability to
allow callers to chat with each other
as if they were chatting with the sysop.
Each character typed at one node is sent
immediately to the other node. In con-
trast to this method, regular chat uses
chat files which ^x0AGAP^n must constantly
read and write. In addition, characters
are sent a line at a time and not until
the caller presses enter to end a line.

It should be noted that Novell's imple-
mentation of NetBios is buggy, to say the
least. In short, it just plain does not
work!

NetBios chat works very well with
Lantastic and other true NetBios networks
@@SET8C
Default colors:

  1 - ^x01Blue          ^n9 - ^x09Light Blue
  2 - ^x02Green        ^n10 - ^x0ALight Green
  3 - ^x03Cyan         ^n11 - ^x0BLight Cyan
  4 - ^x04Red          ^n12 - ^x0CLight Red
  5 - ^x05Magenta      ^n13 - ^x0DLight Magenta
  6 - ^x06Brown        ^n14 - ^x0EYellow
  7 - ^x07Light Grey   ^n15 - ^x0FWhite
@@SET8D
^x0AGAPMENU^n will blank the monitor after the
number of minutes of inactivity that you
specify here.
@@MES_MAX
The message files are capable of holding
1.2 billion messages, however a limit of
^x0C9999^n messages has been imposed to keep
the message files to a managable level.
@@MES_MAXLINE
^x0AGAP^n allows up to ^x0C800^n lines per message,
however, you will need over 58k of
free memory to hold a single message.
This is normally not a problem but
should be kept in mind if you are using
a multi-tasker.

A good starting point is ^x0C99^n lines. It is
best to start low and increase the number
if necessary since lowering the limit
will prevent you (or your callers) from
reading any message that has more lines
than the limit.
@@MES_CARBON
Private messages may be sent to up to 99
users if the ^x0CAllow CC Messages^n flag is
set to Yes.
@@MES_VALIDATE
If you want ^x0AGAP^n to check the user file
to see if the person to whom a message
is being left is an actual user of the
BBS, set the ^x0CValidate Messages^n field to
Yes. Note that Echo Mail Forums and
Forums that allow Handles will disable
this feature for those particular Forums.
@@MES_ESC
Callers will often times "upload" ANSI
text files into their messages. This is
fine if the person reading the message
has ANSI color enabled, but callers with
B&W monitors will see nothing but
garbage. If you wish to prevent callers
from entering ANSI escape sequences in
their messages, set the ^x0CAllow Non-ASCII
^x0CChrs^n field to No.
@@MES_DEL
You can prevent callers from deleting
their messages by setting the ^x0CAllow
^x0CKilling Of Msgs^n to No. Veteran sysops
will tell you the tale of the caller who
logged on one day and deleted all the
messages to and from him, simply because
of a bad day at the office or school. If
this occurs in a Forum that depends upon
the exchange of ideas between callers,
this could have a devastating effect on
the Forum atmosphere, not to mention the
time and energy taken from the sysop in
trying to restore those messages.
@@MES_PRIV
If you would like to force all messages
that are entered to be private, set this
field to ^x0CYes^n.
@@NEW_NEWS
If you wish for the news file to be dis-
played to callers only if it is new, set
the ^x0CShow News Only If New^n field to Yes.
The news file will always be shown to
new users.
@@SET8G
You can set the maximum amount of time a
user may be idle at the keyboard. Enter
the number of minutes of idle time in the
^x0CKeyboard Time-out^n field. Note that when
logging on locally, the time out is 5
minutes. This is to give you enough time
to stop your message reading and get
a cup of coffee!
@@MES_EXTTIME
You may give time credits for leaving
messages (not comments). To do so, set
this field to a number from ^x0C1^n to ^x0C9^n.

After entering a message and saving it,
^x0AGAP^n will multiply the amount of time it
took to enter the message by the factor
you enter here.

A factor of ^x0C1^n means the caller will not
loose any time.

Note that if you enter a ^x0C0^n here, a
caller will not be given any time
credits and will actually loose time
while entering the message.
@@SET8I
While replying to a message, callers may
quote pieces of text from the message
they are replying to. You may choose the
characters to use for the quotes. The
quote characters appear at the beginning
of the line of text that was quoted.

Many sysops feel that quoting is mis-used
and should not be allowed. If you wish to
disable quoting, leave the ^x0CMessage Quote
^x0CChars^n field blank.

If you enter an ^x0CI^n as the first character
in this field, ^x0AGAP^n will use the initials
of the person you are quoting.

For instance, if you enter ^x0CI>^n as the
quote characters, and you are quoting
from Jim Smith, ^x0AGAP^n would place ^x0CJS>^n as
the quote characters in front of the
quoted text.

If you enter an ^x0CG^n as the first character
in this field, ^x0AGAP^n will surround the
quoted text with a Graphic Box.

Note that the Line Oriented Editor does
not support this Graphic Box, and if
configured, the Line Editor will use the
caller's Initials instead.
@@SET8J
The ^x0CAnsiCmd Character^n is the single
character that is used to preceed the
special commands that ^x0AGAP^n processes in
Text Files.

Previously this character was hard coded
as an <Alt> 255 (hex FF). You may now
use any character you like.

We suggest that you use the AT
character '^x0C@^n'.

If you wish to actually use the
AnsiCmd character in your files, then
use two of them. For instance, if your
^x0AAnsiCmd^n is '^x0C@^n' and you wish to use an
'^x0A@^n' in your text, then you would use
^x0C@^n^x0A@^n.
@@SET8K
If you would like for the Main Board
Messages to be ^x0AEchoable^n, set this flag
to ^x0CYes^n.

Note that it is not recommended that you
echo the Main Board Messages since their
topic is generally of a local nature.

This feature is provided for those
Boards that have remote Nodes attached
to them.
@@SET9A
If ^x0CEnforce Download Count^n is set to Yes,
users will be limited to the maximum
number of files you specify in ^x0ASECLEV^n for
their security level, per day.

If ^x0CEnforce Byte Count^n is set to Yes,
users will not be allowed to download any
files on any particular day if they have
already used up their allotted count.
The number of bytes they are allowed to
download during any single day is set up
in the ^x0ASECLEV^n file.
@@SET9B
If ^x0CExtend Download Count^n is set to Yes,
then for every file a caller uploads,
their maximum number of download files is
increased by 1. This basically gives the
caller a 1 for 1 upload credit as far as
files are concerned.

^x0CExtend Time By Factor^n allows you to
specify a multiplier that will be used to
give back the time spent uploading. GAP
will multiply the time it took to upload
a file by this factor and credit the
caller with that time. Note that if you
enter 0 in this field, the caller will
actually loose time.
@@SET9C
GAP allows you to enforce upload and
download ratios. You may do this by
either files or bytes.

By files means the callers must maintain
the ratio specified in ^x0ASECLEV^n or ^x0AGAP^n will
not allow them to download any files. If
you specify by Bytes, the callers must
maintain the ratio specified, however,
the number entered into ^x0ASECLEV^n is the
number of k-bytes that must be main-
tained.
@@SET9D
If ^x0CPrivate Uploads^n is set to Yes, all
uploads will be given a security level of
110. This allows the sysop to review any
uploads prior to making them available
for downloading.
@@SET9E
This feature is not yet operational.
@@SET9F
The ^x0CMinimum Free Upload Space^n is the
amount of free space that must be left
on the hard drive before ^x0AGAP^n will
accept an upload.

If you want ^x0AGAP^n to show the free up-
load space to the caller, set the
^x0CShow Free Upload Space^n to yes. This
option is provided because many sysops
do not like to show this information.
@@SET9G
You may install up to 20 External
Protocols. To activate them, enter Yes
in the ^x0CExternal Protocols^n field and in
the ^x0CProtocol Filename^n field, type in the
the name of the file (which will reside
in your ^x0AGEN^n directory) that holds the
external protocol information. You may
edit this file by selecting
^x0AExt Protocols^n from the Files Menu.
@@SET9H
Enter here the Default Filename
Extension you would like ^x0AGAP^n to use
when callers enter a filename without
an extension during Archive Viewing,
Downloading, etc.

This extension will also be used when
^x0AGAP^n verifies an Upload. Upon return from
an Upload check, if the file that ^x0AGAP^n is
checking has disappeared, ^x0AGAP^n will
substitute the extension you enter here
for the extension that was on the Upload
prior to the check, and if ^x0AGAP^n now finds
the file, it will know to rename in in
the FileBase.
@@SET9I
Normally when ^x0AGAP^n searches for a dupli-
cate file during an Upload, it searches
only the current Area the caller is in.

The reason for this is so that you can
keep different files with the same name
in different Forums.

If you wish to disable this and have ^x0AGAP^n
check all Areas for a file, set this
field to Yes.
@@UPLEV
This is the security level that will be
given to all files uploaded to the Main
Board that are public.
@@PRIV_UPLEV
This is the security level that will be
given to all files uploaded to the Main
Board that are private (for Sysop Only).
@@SET9K
You may have up to ^x0C999^n Main Board File
directories. The upload directory will
be the highest numbered directory.
@@NUMFORUMS
Enter the total number of Forums you wish
to set up. This number should represent
the number of Forums you intend to set up
at this time. Do not enter a number
higher than the number you plan to run
since all Forums must be properly
configured and the configuration depends
upon the number you enter here.

If you are setting up for the first time,
it is best to set this field to 0 and
then configure your Forums at a later
time when you are more comfortable with
the system.
@@SET11
The ^x0CAdditional Board Name^n is any text you
wish to have displayed after your BBS
name.

The ^x0CTwit String^n is displayed to the user
when the sysop presses the TWIT key to
log a caller off.

The ^x0CLockout String^n is displayed to the
user when the sysop pressed the
LOCKOUT key to lock a user out and to
log him/her off.

The ^x0CComment Prompt^n is displayed to the
user when he/she leaves a comment.
@@SET12
This screen allows you to configure the
manner in which the Caller Analyzer
operates.

You may specify the bulletin number to
assign to the bulletin files produced
by the program. You may also specify
whether or not you want the program
to update your Bulletin Menu with the
current date and time, and whether or
not you want the program to delete your
caller logs after reading them.

Please refer to the manual for more
detailed instructions on configuring
and running ^x0AGAPCALL^n.
@@SET13
The ^x0CShift Function Keys^n may be programmed
to display any information you like.
@@FORUM_NAME
This is the name you wish to assign to
the Forum. ^x0AGAP^n will display this name
at various points while a caller is
inside the Forum.
@@FORUM_DIRS
The ^x0CForum Directory Path^n is the drive
and path to the Forum ^x0ADEFAULT^n directory.
The Message files will be placed here.

The ^x0CGen Directory Path^n is the drive and
path to the Forum ^x0AGEN^n directory. If the
Forum uses its own specific menus, they
must be placed here. This path can be
set equal to the ^x0ADEFAULT^n directory path.

The ^x0CUpload Directory Path^n is the drive
and path where the Forum uploads are to
be placed.

Note that you must provide a drive
designator. Failure to do so will cause
GAP to operate improperly.

You may not leave any of these fields
blank. ^x0AGAP^n needs the information they
provide so ^x0AGAPSETUP^n will not allow you
to move the cursor out of the field if
it is blank.
@@FORUM_MSGS
This is the name to give to the Forum
^x0AMessage File^n. A ^x0C.DAT^n extension will
automatically be appended. If you have
several ^x0AMessage Only^n Forums, you may
place them all in the same directory and
simply give each a different name for
the Message File.
@@FORUM_DATE
It is possible for you to "rent out" a
Forum to outside parties to run as they
see fit. You may set a date that the
Forum will expire. When that date arrives
no user save the sysop will be allowed to
enter the Forum. If you do not wish to
use this feature, be sure to set the
Subscription Date to 01/01/01.
@@FORUM_SYSOP
Each Forum may have a dedicated sysop and
assistant sysop.

User's are assigned Forum Sysop or
Forum Assistant Sysop status for a
partucular Forum in the User Editor.

You assign the security levels for the
Master and Assistant Sysops here.

The security level is the actual level
you want the user to have when he/she
joins the Forum. It is not an additional
level, but the exact level that will be
given to the user. If the Forum is set
up to give additional security, the
Forum sysops will not be given the
additional security.
@@FORUM_PUBLIC
If this Forum is a Public Forum, then
set the ^x0APublic Forum^n field to ^x0CYes^n, and
in the ^x0ALevel To Join^n field, enter the
security level that a user will need in
order for the user to join the Forum.

If the Forum is ^x0APrivate^n, enter ^x0CNo^n in
the Public Forum field. The only way for
a user to join a Private Forum is if the
Sysop manually adds the user to the
Forum Membership record.
@@FORUM_BLTS
If the Forum is to have its own set of
bulletins, enter the total number here.
Don't forget to create a ^x0ABLT^n file to list
the bulletins and place it in the ^x0AGEN^n
directory.
@@FORUM_SECURITY
If you wish to increase a user's security
level while he/she is in the Forum, enter
the additional level to add to the user's
normal level here.
@@FORUM_TIME
If you wish to grant your users any
additional time while they are in the
Forum, enter the number of minutes to add
to their time here. Note that a user will
be granted additional time once only.
Also, they will not loose the additional
time when the abandon the Forum.
@@FORUM_UPLEVEL
This is the security level that will be
given to public uploads that are kept in
the Forum.
@@FORUM_PRIVUPL
This is the security level that will be
given to private uploads that are kept
in the Forum.
@@FORUM_NUMDIRS
If the Forum is to have any additional
file directories, enter the number of
additional directories here. Note that
the Forum upload directory will be the
highest directory number.

  Example: If the main board has 10
  directories and the Forum has 2
  additional directories, while a user
  is in this Forum, there will be a
  total of 12 directories. Subject 11
  will be the main board upload direc-
  tory and subject 12 will be the
  Forum's upload directory.
@@FORUM_MAINDIRS
If this field is set to No, the Forum
directories will be completely isolated
from the main board directories. This
means the main board directories will
not be available while inside the Forum.
Instead of starting with the highest
main board directory plus one, the Forum
directories will start at 1.
@@FORUM_HANDLE
If this Forum utilizes handles, enter ^x0CYes^n
in this field. While in a Forum that
allows handles, a user's name will change
to their handle.
@@FORUM_AJOIN
If this field is set to ^x0CYes^n and a user
logs off from inside the Forum, he/she
will automatically "join" the Forum on
the next call.
@@FORUM_PRIVUP
If you want all the Forum Uploads to be
private, set the ^x0CPrivate Uploads^n field to
Yes.
@@FORUM_KEEPUP
If you want all the Forum uploads to be
kept in the Forum upload directory, set
the ^x0CKeep Uploads^n Inside field to Yes.
Otherwise, the user will be asked if he
or she wishes the upload to stay in the
Forum.
@@FORUM_MESPUB
You can force all mail that is entered
to be public. Note that this field is
mutually exclusive of the previous
field. Only one of the two fields can be
set to Yes.

The sysop can override the public
setting and leave private mail.
@@FORUM_COMMAIN
If you want all Comments that are
entered while a user is inside this
Forum to be placed in the Main Board
Message File, set this field to ^x0CYes^n.
@@FORUM_ECHO
If you want the messages in a Forum to be
utilized in an Echo Mail system, set this
flag to ^x0CYes^n. ^x0AGAP^n will then ask a caller
if a particular message should be echoed
or not.
@@FORUM_SUB
If this Forum is Private and you wish to
make it a ^x0ASubscription Forum^n, enter the
number of days in the Subscription
Period.

Your subscription period can be any
number of days from ^x0C7^n to ^x0C365^n.

If you do not wish to make the Forum a
subscription Forum, leave this field set
to ^x0C0^n.
@@FORUM_SUB1
If this Forum is a Subscription Forum and
a user's supscription has expired, GAP
will remove the user from the Forum by
deleting his/her Member Record (the user
will then not be allowed to join until
the Sysop adds the user to the Forum's
Membership.

If you do not want GAP to automatically
remove the user from the Forum, answer
^x0CNo^n in this field.
@@SET15A
Some programs may lock up the computer
if ^x0AGAP^n protects the status line.

If you want ^x0AGAP^n to remove the sysop
status line and not attempt to protect
lines 24 and 25 of the screen during a
DOS shell, set this field to ^x0CYes^n.

This toggle is effective only if you
answered ^x0CYes^n in the previous Field.
@@SET15B
^x0AGAP^n and many of its external programs
have the ability to shell to DOS or run
other programs while at the same time
"remembering" the exact point in the
program you were at prior to the shell.

When you return from DOS or another pro-
gram the screen will be restored exactly
like it was and you will be returned to
the same place in the program.

In order to accomplish this, ^x0AGAP^n will
"move" itself from active memory to
either ^x0CEMS^n or a disk file. At the same
time, all the memory ^x0AGAP^n occupied (with
the exception of about 8k) will be
freed, leaving you with just about the
same amount of memory you had prior to
running ^x0AGAP^n.

This flag is provided so that you may
prohibit ^x0AGAP^n and its other programs from
using ^x0CEMS^n. If you do NOT have ^x0CEMS^n
memory, you do not need to set this flag
as it cannot be used anyway. If you have
^x0CEMS^n memory, the only reason you would
ever want to set this flag to ^x0CNo^n is if,
during a DOS shell, you intend to run a
program which is not well behaved and
which allocates ^x0CEMS^n for itself in non-
standard ways.

In general, you should set this flag
to ^x0CYes^n.

You should set aside (that is, not use)
at least ^x0A400k^n of ^x0CEMS^n for use by ^x0AGAP^n
and its utility programs.
@@SET15C
Please refer to the Help text for the
previous field for further explanation
of ^x0CEMS^n memory during a program swap.

If ^x0CEMS^n is not available for swapping,
^x0AGAP^n will use your hard disk. You will
need to have at least 400k of free disk
space for use by ^x0AGAP^n and its utility
programs.

There should never be a reason to type
a Hard Disk drive designator here unless
you have a RAM Disk setup and you wish
to use the RAM Disk as a swap drive. If
this field is left empty, ^x0AGAP^n will use
the current disk and directory to write
the swap file to.
@@SET15D
You may configure ^x0AGAP^n to run in a Local
Area Network Environment. As such, you
will not want your "local" users to
perform Sysop Functions by using the
Sysop Keys that are available only from
the local keyboard (for instance, raising
or lowering the caller's security level).

If you set this flag to ^x0CYes^n, then your
Local Users will not be able to perform
any Sysop Functions that are activated
from the local keyboard.
@@SET15F
Pressing F5 while in the BBS allows you
to shell to DOS where you may perform
any DOS function or run other programs.

If you enter ^x0CYes^n in this field, ^x0AGAP^n will
use ^x0ACOMMAND.COM^n to perform the shell.
This means that ^x0AGAP^n will remain in memory
while you are in the shell. The type of
program you run (if any) while in the
shell depends upon how much free memory
is available (remember that ^x0AGAP^n will
still be in memory).  This option also
alows you to disable the Status Line if
necessary.

If you enter ^x0CNo^n in this field, ^x0AGAP^n will
use the swapping techniques discussed in
a previous help screen. This means that
^x0AGAP^n will swap itself to either EMS or
disk, freeing up all memory except for
about 8k, giving you more memory to work
with while in the Shell. The Status Line
will be removed and the screen cleared.
However, when you return from the shell,
the screen will be restored exactly like
it was, so no information will be lost.
This is not possible with the ^x0ACOMMAND.COM^n
shell.
@@SET15H
A setting of ^x0C4^n is recommened here.

At log on, ^x0AGAP^n tries to determine if the
caller has ANSI emulation turned on. ^x0AGAP^n
does this by sending an ANSI sequence to
the remote terminal and then waits for a
reply.

With most callers, a wait period of ^x0C4^n
^x0Cseconds^n is sufficient. Some systems are
slow to respond so you may need to
increase the amount of time ^x0AGAP^n waits
for a response.

Keep in mind that if the caller has no
ANSI terminal emulation, then too high
of a wait period will be noticable.

You may disable the Auto ANSI detect by
placing a ^x0C0^n in this field.
@@SET15I
^x0AGAP^n tries its best to insure that no
Event will be missed. There are times,
when a caller will overstay his or her
alloted time, thereby potentially
causing an event to be missed (^x0AGAP^n can
catch one missed event, but if events
are scheduled one after the other, it is
likely the others will be missed).

One of the places where a caller might
overstay the alloted time is during a
file transfer. Even though ^x0AGAP^n knows how
long a download should take, there is no
way of knowing what type of equipment a
caller is using which could cause the
transfer to take longer than it should.

On uploads, ^x0AGAP^n has no way of telling
how long a tansfer will take.

You have two options with regards to
missed events and file transfers: Either
allow the transfer to complete and let
^x0AGAP^n catch the missed event (this is fine
for events that are not time critical),
or stop the transfer as soon as the
Event timer expires (this may be needed
for an Event that MUST run at the
specified time). In this case, ^x0AGAP^n will
cancel the transfer and the caller will
be logged off due to expired time.
@@SET15J
A setting of ^x0C30^n is recommened here.

You may specify the Guard Time that ^x0AGAP^n
will use to prevent any uploads if an
Event is pending. If the caller's time
left is less than or equal to this Guard
Time, ^x0AGAP^n will not allow the caller to
upload any files.

Since you have no way of telling how
long it will take a caller to upload a
file(s), it is still possible for a
caller to begin an upload and overstay
his or her alloted time. The Guard Time
is just a preventive measure but not
infallable.

Notice that you cannot disable this
field. If set to ^x0C0^n, ^x0AGAP^n will use the
default of 30 minutes.
@@SET15K
A setting of ^x0C15^n is recommended here.

Door programs are probably the number
one cause for missed Events. This is
because many doors do not monitor the
caller's time or do not use the caller's
time remaining as provided by ^x0AGAP^n as the
basis for allotting time in the door.

You may close all doors prior to an Event
by setting this field to a number other
than 0. If the caller's time remaining
is less than or equal to this Guard Time
^x0AGAP^n will not allow the caller to enter a
door.

A setting of ^x0C0^n disables this feature.
@@SET15L
^x0AGAP^n can display a file to a specific
User when the User logs on. The name of
this file consists of the first 5
characters of the User's Last Name and
the first character of the User's First
Name.

This file resides in your \GAP\MAIN\USER
directory.

After ^x0AGAP^n displays the file, ^x0AGAP^n can
delete the file for you. If you answer
^x0CYes^n in this field, ^x0AGAP^n will delete your
User Specific File.
@@SET15M
When a caller downloads a file that is
contained in one of your ^x0ALoose File^n
^x0ADirectories^n, ^x0AGAP^n normally logs the
download to the caller log such that
^x0AGAPCALL^n will show the file in the Down-
load bulletin that it creates.

If you wish to prevent ^x0AGAPCALL^n from
showing files downloaded from a Loose
Directory, set this field to ^x0CNo^n.
@@SET15N
If you run a subscription board, set
^x0CEnforce Subscription^n to Yes. Any
caller whos subscription has expired
will be set back to the Expired Sub-
scription Level as defined in their
User Record. The User Record also
contains an option to remove the user
from any Private Forums the user might
be registered in.
@@SET15O
Enter the number of days you wish to
have in your Subscription Period. This
can be from ^x0C7^n to ^x0C365^n days.

If you subscription period is less than
14 days, then your callers will receive
no warning that their subscription is
about to expire.

If your subscription period is greater
than 14 days but less than 30 days,
then ^x0AGAP^n will begin issuing warnings
to callers 5 days prior to the date
their subscription expires.

If your subscription period is greater
than 30 days but less than 60 days, then
^x0AGAP^n will begin issuing warnings to
callers 10 days prior to the date their
subscription expires. The warn time for
periods greater than 60 days is 30 days.
@@SET15P
If you wish to exempt certain users from
the Subscription functions, enter the
Exempt Security Level here.

Any user who's security level is at or
above this level will never have their
security level adjusted if their
Subscription Date has Expired.
@@SET15Q
When a user's subscription has expired,
if you would like for their ^x0APrivate User^n
^x0AFlag^n to be set back to ^x0ANo^n, answer ^x0CYes^n in
this field.

Otherwise, when a user's subscription is
expired, the user will still be able to
gain access to your private nodes.
@@SET15R
Users whos subscription has expired will
be given the level for ^x0CExpired Subscrip^n
^x0CLevel^n.

This should not be the same level given
to new users.

The level that an expired user is set to
is actually defined in the user's record.
The level you enter here is the default
level given to all new users.
@@WRITE_DOORSYS
If you would like for GAP to write a
DOOR.SYS file when a caller first logs
on, answer Yes in this field.
@@DOOR_RETURN
Normally, when a user returns from a
Door, GAP goes back to the Main Command
Prompt. If you would rather GAP stay at
the Door Menu, answer ^x0CYes^n in this field.
@@SET16
^x0AGAP^n allows for 24 ^x0ATimed Events^n. To
activate the ^x0AEvents^n, set this field to
^x0CYes^n.

While traversing the following fields,
You may use the [^x0C^n] & [^x0C^n] Keys to move
^x0AUp^ and ^x0ADown^n a specific Column. The
[^x0CEnter^n] Key will move the cursor from
field to field (left to right order). If
you need to move the cursor to the
Previous Field (the one to the left of
where the cursor currently is, press
[^x0CCtrl^n] [^x0CHome^n].
@@SET16A
You have the option to individually
turn an ^x0AEvent^n ^x0COn^n or ^x0COff^n. To activate an
^x0AEvent^n, set this field to ^x0CYes^n. To keep an
^x0AEvent^n from running, set this field to
^x0CNo^n.
@@SET16B
The ^x0AEvent Time^n is the time of day you
want the ^x0AEvent^n to run. The times are in
24 hour format. You may use any time
from ^x0C00:00^n to ^x0C23:59^n.

Try to be selective with your ^x0AEvent^n
^x0ATimes^n. For instance, if Event 1 is set
to go off at 00:01 and Event 2 is set to
go off at 00:02, you run the risk of
Event 2 never running due to the fact
that Event 1 may take longer than one
minute.

Remember that there is always a 5 minute
guard time. This means that ^x0AGAPMENU^n will
halt ALL operations 5 minutes before the
Event is scheduled to run. In the case
of running one event right after the
other, it would be better to schedule
the two Events 5 minutes apart than to
schedule the second Event 1 minute after
the first.

Also keep in mind, that any Event that
is schedule to run on a particular day
will run ONLY if its Event Time does
not conflict with an Event that runs
every day at the same time. For
instance:

   Event 1 is scheduled at 1:00
   every day.

   Event 2 is scheduled at 1:00 only
   on Mondays.

Event 1 will ALWAYS go off providing
it appears first in the Event List.

Event 2 will NEVER go off if it
appears AFTER Event 1 in the Event
List.

Event 2 WILL go off it if comes before
Event 1 in the Event List. In this
case, Event 1 will never run on a
Monday.

Be selective with your Event times.

Never use the same time more than once.

Try to schedule your times so that they
are no closer than 5 minutes.

When determining which Event is
scheduled next, ^x0AGAPMENU^n will look at the
first record of the Event File. It will
store the Event time away. Then it will
look at the next record. If the next
record is scheduled to run on THIS
particular day, ^x0AGAPMENU^n will look to see
if its Event Time is less than the time
previously stored. If it is less, then
this current event will be scheduled.

As you can see, any Event that has time
conflicts with a prior Event in the list
will override the prior Event and
prevent it from running.

It is best to keep all Event Times
unique. This way, will can be
assured that all events will run.
@@SET16C
The ^x0ADay^n field is the Day of the Week you
want the ^x0AEvent^n to run. The valid choices
here are:

    ^x0CALL^n - ^x0ARun the Event Every Day^n
    ^x0CSUN^n - ^x0ARun the Event on Sunday^n
    ^x0CMON^n - ^x0ARun the Event on Monday^n
    ^x0CTUE^n - ^x0ARun the Event on Tuesday^n
    ^x0CWED^n - ^x0ARun the Event on Wednesday^n
    ^x0CTHU^n - ^x0ARun the Event on Thursday^n
    ^x0CFRI^n - ^x0ARun the Event on Friday^n
    ^x0CSAT^n - ^x0ARun the Event on Saturday^n
@@SET16D
This is the fully qualified path and
name of the ^x0AEvent File^n that is to be
run. If you do not enter a path, then
the ^x0AEvent Batch^n file is expected to be
in the GAP DEFAULT directory. The file
is a DOS Batch file and therefore must
have the ^x0A.BAT^n extension.
@@GOTOH
Select a Forum Number that you wish to
Go To.

Valid Forum Numbers range from 1 to the
maximum number of Forums that you have
configured.
@@MENU_SECLEV
This Menu Item will allow you to edit
your SECLEV file(s).

The SECLEV file is the file that assigns
Time, Bytes, Files, and other parameters
to users with a specific Security Level.
@@SEC_NAME
Select a ^x0AFile Name^n to Edit from the list
on the right.

SECLEV files with an extension are
special files that are applicable to
callers with a certain baud rate or who
call during a certain time of day.

The first 2 characters of the extension
represent the time of day, and the last
character is the baud code where:

      1 =  300 baud
      2 = 1200 baud
      3 = 2400 baud
      4 = 9600 baud

The time is in 24 hour format, and a
time of '00' means ignore the time
checking.

 Some examples:

 SECLEV     = Regular
 SECLEV.170 = Use at 5:00 pm, any baud
 SECLEV.181 = Use at 6:00 pm, 300 baud
 SECLEV.193 = Use at 7:00 pm, 2400 baud
 SECLEV.001 = Use at any time, 300 baud
 SECLEV.002 = Use at any time, 1200 baud
 SECLEV.003 = Use at any time, 2400 baud
 SECLEV.004 = Use at any time, 9600 baud

If you wanted to severly restrict 300
baud callers at 6:00 pm, but only mildly
restrict all other baud rates at the
same time, you could have two SECLEV
files such as:

    SECLEV.181   and   SECLEV.180

This works because GAP looks for the
files in the following order:

    Time / Baud file
    Time / No Baud file
    No Time / Baud file
    SECLEV
@@MENU_DOORS
This Menu Item will allow you to edit
your DOORS.DAT file(s).
@@MENU_PROTO
This Menu Item will allow you to edit
your PROTO.DAT file.
@@SEL_FILE
Select a ^x0AFile Name^n to Edit from the list
on the right.
@@SAVECHANGES
You have pressed ^x0CEsc^n to ^x0AQuit^n, however
changes were made to the current file
which have not yet been saved.

If you wish to save the changes, answer
^x0CYes^n. Otherwise, press ^x0CEsc^n or answer ^x0CNo^n.
@@SEC_SAVEAS
Enter the ^x0AFile Name^n that you wish to
save the current file as. Only valid
file names as previously configured will
be accepted.

SECLEV files with an extension are
special files that are applicable to
callers with a certain baud rate or who
call during a certain time of day.

The first 2 characters of the extension
represent the time of day, and the last
character is the baud code where:

      1 =  300 baud
      2 = 1200 baud
      3 = 2400 baud
      4 = 9600 baud

The time is in 24 hour format, and a
time of '00' means ignore the time
checking.

 Some examples:

 SECLEV     = Regular
 SECLEV.170 = Use at 5:00 pm, any baud
 SECLEV.181 = Use at 6:00 pm, 300 baud
 SECLEV.193 = Use at 7:00 pm, 2400 baud
 SECLEV.001 = Use at any time, 300 baud
 SECLEV.002 = Use at any time, 1200 baud
 SECLEV.003 = Use at any time, 2400 baud
 SECLEV.004 = Use at any time, 9600 baud

If you wanted to severly restrict 300
baud callers at 6:00 pm, but only mildly
restrict all other baud rates at the
same time, you could have two SECLEV
files such as:

    SECLEV.181   and   SECLEV.180

This works because GAP looks for the
files in the following order:

    Time / Baud file
    Time / No Baud file
    No Time / Baud file
    SECLEV
@@SAVEAS
Enter the ^x0AFile Name^n that you wish to
save the current file as. Only valid
file names as previously configured will
be accepted.
@@OVERWRITE
A file with the name you just specified
already exists. If you wish to overwrite
the file, answer ^x0CYes^n. Otherwise, answer
^x0CNo^n and you will prompted for the ^x0ASave As^n
file name again.
@@SEC_LEVEL
This is the security level that a user
must have in order to receive the
allotments specified in the other
fields.

When a user logs on, ^x0AGAP^n will scan the
^x0ASECLEV^n file and look up the user's
security level. The Minutes, Bytes,
Files, Ratio and other flags in this
file will be assigned to this user.

If a user's level cannot be found in this
file, the user will receive the allot-
ments associated with the next highest
level.
@@SEC_MINS
This is the number of ^x0CMinutes^n that a
user with the associated security level
is given for on-line time during the
current session.
@@SEC_BYTES
This is the number of ^x0CBytes^n that a user
with the associated security level is
allowed to download during the current
session.

This number is the number of "K" Bytes.
^x0AGAP^n will multiply this number by 1000 to
determine the user's allowable download
bytes.
@@SEC_MFILES
This is the number of ^x0CFiles^n that a user
with the associated security level is
allowed to download during the current
session.
@@SEC_RATIO
This is the ^x0CUpload/Download Ratio^n that
a user with the associated security level
must maintain.

If you do not wish to enforce Ratios,
enter 0 in this field.

If a caller attempts to download a file
and his/her ratio is greater than the
ratio allowed, a file called RATIO will
be displayed. This file would explain
why the caller is unable to download and
what must be done to rectify the
problem.

If you enforce ratios by Bytes, then the
number entered in this field is the
number of "K" bytes that must be main-
tained. If you enforce ratios by Files,
then this number is the number of files
that can be downloaded per each file
uploaded. Note that 0 uploads is the
same as 1 upload.
@@SEC_ASK
This is a Yes/No field where you specify
whether or not ^x0AGAP^n should do random
checking to determine if a user with
the associated security level entered
a valid BirthDate and Home Phone Number.

In order to use this feature of ^x0AGAP^n, you
must have ^x0APrompt for Birthday^n set to
^x0CYes^n.

Normally, you would answer ^x0CYes^n in this
field only for those security levels that
are at or below your New User level. You
would not want to burdon your registered
callers with this random checking of
Dates and Phone Numbers.
@@DOOR_NAME
This is the ^x0AName^n you wish to give this
particular Door. Names may be up to 15
characters in length, contain any com-
bination of upper and lower case letters
but may ^x0Cnot^n contain any spaces.

If a user attempts to open a door by
simply typing its name at the Command
Prompt, the name you enter here is the
name GAP will look for to see if there
is a match with the name the user typed.
@@DOOR_LEVEL
This is the ^x0ASecurity Level^n a user must
have in order to Open this particular
Door.
@@DOOR_PATH
This is the full Path and Name to this
particular Door Batch file (or program).

When GAP opens this door, it will use
the information you type in this field
to find and run the door.
@@FAILEDCHECK
This is the security level a user will
be set back to if he/she fails the
random Birthday/Phone Number verifica-
tion.

This level should be a special level
that gives the user very limited
access.

The user will also have his/her Forum
access set back to the Default Forums.

Only those users who's level (as
specififed in the SECLEV files), has the
^x0AASK^n field set to Yes, will be randomly
prompted to verify their phone number
and/or Birthdate.
@@ATTACH
This is the directory where files that
are ^x0AAttached^n to a Message are placed.

This directory should be the same for
all Nodes in the system.
@@FIXUSER
When deleting a file, you have the
option to update the Upload Statistics
of the User who uploaded the file such
that the user's upload count will be
decreased by 1 and the user's upload
bytes will be decreased by the number of
bytes the file contains.

If you answer Yes to this question,
GAPFILE will update the user record for
the user name that is displayed. If you
answer No, the user who uploaded the
file that was just deleted will have
upload credits for the file (even
though it no longer exists).

If you are using Mass Delete or Move
Files (from the Utility Menu), this
window will appear everytime a file is
deleted. If you would like for the
uploader's Upload Statistics to be
updated with each delete and not be
prompted each time the deletion takes
place, you may answer All in response
to the question. The window will no
longer appear for any subsequent
deletions; the upload statistics for all
uploaders will be updated.

You may also choose to not update the
uploader's statistics for this and
subsequent deletions by selecting
Ignore.
@@PROT_LTR
This is the character the user must type
to select this protocol. It can be any
character of your choosing but it can
^x0Cnot^n be a character representing an
internal protocol.

For instance, you can use ^x0CD^n for ^x0ADSZ^n, ^x0CH^n
for ^x0AHS-Link^n.

This character also makes up the 5th
character in your EXTSx.BAT and
EXTRx.BAT files. Where the ^x0Cx^n is the
character you enter in this field.
@@PROT_BATCH
If this external protocol can transfer
multiple files in a single invocation
then you should set this field to ^x0CYes^n.

Note that if the external program claims
to be a batch protocol, it must write
a DSZ type of log file (DSZLOG). If it
does not write this log file, then you
must set this field to ^x0CNo^n. It must also
be able to read an indirection file,
which is a text file that contains a list
of files that will be sent to the remote
caller.
@@PROT_BIDIR
If the external protocol can transfer
files in both directions : can Send and
Receive files at the same time, set this
field to ^x0CYes^n.
@@PROT_MNP
If the external protocol requires an ^x0CMNP^n
connection (one where the modems perform
all of the handshaking), set this field
to ^x0CYes^n. If the caller does not have an
^x0CMNP^n connection and yet the caller
selects this protocol, ^x0AGAP^n will issue a
warning message informing the caller
that he/she does not have an error
correcting connection.
@@PROT_PRO
Some programs may lock up the computer
if ^x0AGAP^n protects the status line.

If you want ^x0AGAP^n to remove the sysop
status line and not attempt to protect
lines 24 and 25 of the screen during an
External File Transfer shell, set this
field to ^x0CNo^n.
@@PROT_NAME
This is a descriptive name to give to
the external protocol. It will be
displayed to a caller whenever the
caller uses this protocol to download
or upload files.
@@UPCHECK_NAME
Enter the name of the batch file to run
for each file that is found and imported
into the FileBase.

This name can be UPCHECK.BAT if you wish
to run the batch file that GAP uses to
check file integrity.

Or, it can be the name of a different
batch file that contains a subset of the
commands you have in your UPCHECK.BAT.

Normally, when using the Stray Files
function, the files to be imported have
already been subjected to virus testing
so a full file integrity check is not
needed. In such a case, you would want
to use a batch file that simply extracts
a description file (if any) from the
archive so that the included description
file can be used as the file description.
@@MENU_REP
If a Caller uses a Mail Reader program,
GAP can accept a REP packet that most
Reader programs generate.

This is the security level that a user
must have in order to use the REP
Command.
@@MENU_QWK
If a Caller uses a Mail Reader program,
GAP can generate a QWK Mail packet
containing new messages in all of the
Forums (including the Main Board) that
the Caller is registered in.

This is the security level that a user
must have in order to use the QWK
Command.
@@COUNTRY
This is the Sysop's Country. It will be
used as the default Country for New
Users.
@@DDELH
This utility function allows you to
^x0AMass Delete^n all the files that have
the Drive Designator you specify.

As an example, It can be used when you
need to quickly remove all the files
from a CD-ROM.
@@DDELD
This is the Disk Drive Designator a file
must have in order to be deleted.
@@DDELF
If you would like for GAPFILE to also
delete the files from the hard drive,
answer ^x0CYes^n. If you are deleting
files that reside on a CD-ROM, you
should answer ^x0CNo^n to this question.
@@DDELCON
You are being asked to confirm that you
indeed wish to go ahead and ^x0AMass Delete^n
the files with the supplied Drive
Designator. If you answer ^x0CYes^n at this
point, then ^x0AGAPFILE^n will delete the
files.

Press ^x0CEsc^n or answer ^x0CNo^n if you do not
wish to continue.
@@MENU_FOR_HIGH
This Utility allows you to change the
High Message Number for each of your
Forum Message Bases to the highest
number contained in the Message Data
File for a Forum.
@@FIX_HIGHNUM
If a Forum doesn't have any messages (its
Message File contains no messages), you
may set the starting Message Number for
that Forum's Messages. The default number
is 100, which you may accept by simply
pressing Enter in this field.
@@MOVE_DAYS
When moving files, you may specify the
number of days old a file must be in
order to be included in the list of
files that is displayed.

Entering a 0 in this field means that
all files will be included. If you enter
30 in this field, then only files that
are 30 or more days old will be
included.
@@MENU_FOR_ADD
This Utility allows you to add a group
of Forums quickly and easily. The Forums
will be added to the end of your
existing Forums. All of the added Forums
will be placed in the same directory and
will contain identical characteristics
(which you may individually change later
if you wish).
@@FORUM_ADD
This number is how many Forums GAPSETUP
will add to the end of your existing
Forums.
@@FORUM_ADD_DIR
This is the Default Directory each of
the Forums will reside in. The Forum
Message Files will be placed in this
directory.
@@CD_DRIVE
If you are using a Compact Disk Drive
you may want GAP to copy files from the
CD to the work directory on the hard
drive before initiating a download.

CD Drives are much slower to access than
a hard drive and if you are running
multi nodes where several users could be
accessing the CD at the same time,
copying the file to a hard drive will
save much wear and tear on the CD.

If you want GAP to copy files from a CD,
enter the CD's disk drive designator in
this field. Enter just the drive letter,
do not enter a colon after the letter.
If you have more than one CD, or you are
using a disk changer, enter all the
drive letters as appropriate (you may
enter up to 18 different drive letters).

Note that copying files from the CD may
take some time, depending upon how large
the files are and how many of them a
user might be batch downloading.
@@LOCAL_DRIVE
This is the disk drive to copy the files
from the CD on to. If you are running
under a Network, this should be a drive
on the local computer rather than a
drive on the Server. Making the drive a
local drive will speed up the copying
process.
@@MMERGE
This utility function allows you to
Merge a different FileBase into the
current FileBase.
@@MERGE_NAME
This is the full path and name of the
FileBase you wish to merge with the
current FileBase. It is a FILES.DAT file
that has been renamed.
@@INTERFACE
This is the Communications Port
Interface. If you are not using an
Intelligent DigiBoard, this needs to be
set to ^x0AStandard^n.
@@DIGI_SEG
This is the DigiBoard Memory Window. It
is the High Memory Address you have the
DigiBoard Configured to use.
@@DIGI_PORT
This is the DigiBoard I/O Port Address.
@@DIGI_CHNL
This is the DigiBoard Channel Number to
use for this Node.
@